home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_amanda.idb / usr / freeware / doc / amanda / SAMBA.z / SAMBA
Encoding:
Text File  |  1999-07-16  |  5.8 KB  |  143 lines
  1. README for adding PC hosts to the Amanda backup system.
  2.  
  3. Installation
  4.  
  5. Amanda is able to back up Microsoft Windows shared disks by using
  6. SAMBA, a package that implements a SMB client and server for Unix.
  7. Releases from 1.9.18p5 up to 1.9.18p10 would log information in the tar
  8. files it produces, making them unusable (both the tar files and the
  9. releases of SAMBA :-)!  If you really must, a patch that fixes the
  10. problem was posted to the Amanda Users mailing-list; please check the
  11. archives.  The patch may be available in the Amanda Patches Page too.
  12.  
  13. Amanda no longer supports SAMBA releases prior to 1.9.18.  If you're
  14. using SAMBA from 1.9.18 up to 1.9.18p3, make sure you don't set a low
  15. logging/debugging level in smb.conf.  This flag may prevent that
  16. estimate sizes are printed correctly.  Amanda will report an estimate
  17. failure in this case.
  18.  
  19. This problem may also occur if you have large (>2GB) filesystems to
  20. back up with samba.  In this case, apply samba-largefs.patch, after
  21. making sure your C compiler supports `unsigned long long's, and that
  22. printf() in your C library understands that "%llu" means `unsigned
  23. long long'.  gcc may help you getting unsigned long longs, in case
  24. your platform doesn't, but it will not help printf understand "%llu".
  25.  
  26. After building and installing samba with the selected patches, Amanda
  27. must be configured with smbclient support - when you run configure,
  28. add the following argument:
  29.  
  30.  --with-smbclient=/full/path/to/smbclient
  31.  
  32. If you configure --with-smbclient, amanda will try to find smbclient
  33. in the PATH, but if the --with-smbclient switch is not issued at all,
  34. amanda will *not* enable its SAMBA hooks.
  35.  
  36. Setup
  37.  
  38. Once Amanda is installed, the only difference is in how the backup
  39. disks are specified.  For each PC host disk, and entry is placed in the
  40. disklist not for that host, but for the 'samba server' host, where the
  41. patched samba suite is installed.  Instead of a path or a disk
  42. specified in the space provided in the disklist for this purpose, a
  43. sharename is listed.
  44.  
  45. Additionally, a file must be created called /etc/amandapass, which
  46. includes a sharename to password mapping.  Each line of input
  47. lists the sharename in 'Amanda format' (it is case sensitive so
  48. make it identical to the sharename listed in the disklist) followed
  49. by whitespace and then the password, which must not contain spaces.
  50. This file must owned by the amanda user, and without world-read
  51. privileges, or amcheck will complain.
  52.  
  53. The share must be given full access (read/write) to the disk -
  54. otherwise incremental backups will not work and it will always backup
  55. most of the disk (Archive bits never being reset).
  56.  
  57. e.g.
  58.  
  59. Amanda client software, and the patched samba is installed onto a host
  60. 'pcserver'.  A share to be backed up is called 'backupc' on host
  61. 'thepc'.  It has a password on the share of 'f00bar'.
  62.  
  63. The entry in the disklist file is:
  64.  
  65. pcserver    //thepc/backupc        nocomp-user-gnutar
  66.  
  67. ^ samba installed unix host
  68.                  ^ pc host and sharename
  69.                     ^ dumptype must include the tar option
  70.  
  71. And in /etc/amandapass on the machine 'pcserver', this line must be
  72. present :
  73. //thepc/backupc f00bar
  74.  
  75. If smbclient would require a workgroup specification (-W), you may add
  76. it as a third argument in /etc/amandapass line:
  77. //thepc/backupc f00bar NTGROUP
  78.  
  79. This way, smbclient will be invoked with -W NTGROUP
  80.  
  81.  
  82. An example dumptype (from amanda.conf) could be:
  83.  
  84. define dumptype nocomp-user-gnutar {
  85.     program "GNUTAR"
  86.     comment "user partitions dumped with tar and no compression"
  87.     options no-compress
  88.     priority medium
  89. }
  90.  
  91. Essentially the disklist entry is a 'pseudo-disk' which contains all the
  92. relevant information needed by the smbclient program to backup the disk,
  93. but in an Amanda compatible way.  The full sharename shouldn't be greater
  94. than 79 characters.  And the password should not include any whitespace.
  95.  
  96. For NT systems, or where the shares are specified with a username, the
  97. username it connects with is 'backup'.  See bugs for some notes on
  98. this.
  99.  
  100. amcheck does a quick check to see if smbclient exits and also tries to
  101. connect to any appropriate hosts.  It also checks for the existence of
  102. /etc/amandapass, and that the permissions are set appropriately.
  103.  
  104. Bugs
  105.  
  106. SAMBA will not back up open files (such as PAGEFILE.SYS and registry
  107. files) nor Access Control List data.  Furthermore, at restore time,
  108. smbclient is unable to overwrite read-only files.  Hence, Amanda+SAMBA
  109. is not a perfect solution for backing up (restoring, actually) system
  110. disks.
  111.  
  112. SAMBA does not use Windows' Backup API, so configuring the Amanda
  113. backup user as a member of group backup, in the Windows host, is
  114. useless.  You will probably have to configure it as an Administrator,
  115. and make sure that it can read and change permission of *all* files in
  116. the share.
  117.  
  118. It seems impossible to detect when a per-user based login fails - e.g.
  119. the username doesn't exist on an NT workstation.  It connects but you
  120. can't see any files (e.g. backups backup nothing).  The selfcheck code
  121. isn't particularly robust in this area either, so you can get no
  122. warnings when a disk isn't being backed up.  Just check to see that
  123. level 0 dumps are bigger than 64K - otherwise it means the backup was
  124. empty.  (i have code in sendsize to detect this situation, but I don't
  125. know how to flag it, without aborting every disk (or 'pseudo disk') on
  126. that host).
  127.  
  128. The estimate and totals are probably a bit out, since tar pads to the
  129. nearest 512 bytes after each file (i think).  Not sure how much of a
  130. problem this is.
  131.  
  132. If you compile with smbclient support, gnutar support is automatically
  133. added too.  If you aren't using the gnutar part, you may get warnings
  134. about the availability of /usr/local/bin/gtar (or whatever it was
  135. compiled with) - these can safely be ignored, unless you enable index
  136. generation for those filesystems.
  137.  
  138. Original text by:
  139. Michael Zucchi
  140. School of Computer and Information Science
  141. University of South Australia
  142. M.Zucchi@CIS.UniSA.Edu.Au
  143.